.\" $Id: papi_decode.1,v 1.1 2005/05/19 19:35:25 terpstra Exp $
.TH PAPI_DECODE 1 "May, 2005"
.SH NAME
papi_decode \- provides availability and detail information for PAPI preset events.

.SH SYNOPSIS

\fBpapi_decode\fP [\fI-ah\fP]


.SH DESCRIPTION
\fBpapi_decode\fP is a PAPI utility program that converts the PAPI presets for the existing library into 
a comma separated value format that can then be viewed or modified in spreadsheet applications or text editors,
and can be supplied to 
.BR "PAPI_encode_events" "(3) as a way of adding or modifying event definitions for specialized applications."
The format for the csv output consists of a line of field names, followed by a blank line, followed by one
line of comma separated values for each event contained in the preset table. A portion of this output 
(for Pentium 4) is shown below: 

.nf
.if t .ft CW
name,derived,postfix,short_descr,long_descr,note,[native,...]

PAPI_L1_ICM,NOT_DERIVED,,"L1I cache misses","Level 1 instruction cache misses",,BPU_fetch_request_TCMISS
PAPI_L2_TCM,NOT_DERIVED,,"L2 cache misses","Level 2 cache misses",,BSQ_cache_reference_RD_2ndL_MISS_WR_2ndL_MISS
PAPI_TLB_DM,NOT_DERIVED,,"Data TLB misses","Data translation lookaside buffer misses",,page_walk_type_DTMISS
.if t .ft P
.fi

.SH OPTIONS

.TP
\fI-a\fP
Convert only the available PAPI preset events.

.TP
\fI-h\fP
Display help information about this utility.

.SH BUGS 
There are no known bugs in this utility. 
.LP
If you find a bug, it should be reported to the PAPI Mailing List at <ptools-perfapi@ptools.org>. 

.SH SEE ALSO
.BR PAPI "(3), " papi_avail "(1), " papi_clockres "(1), " papi_command_line "(1), " papi_cost "(1), "
.BR papi_event_chooser "(1), " papi_mem_info "(1), " papi_native_avail "(1)"



